API Documentation
Classes | Public Member Functions | List of all members
nkWinUi::FileExplorer Class Referenceabstract

A graphical file explorer. More...

Inheritance diagram for nkWinUi::FileExplorer:
nkWinUi::Component nkExport::Exportable

Classes

class  FileFilter
 Used to filter files in the interface. More...
 

Public Member Functions

 FileExplorer (MainSystem *parentSystem)
 
 ~FileExplorer ()
 
void addFilter (const nkMemory::StringView &label, const nkMemory::StringView &extension)
 
FileFiltergetFilter (unsigned int index)
 
void setFilter (unsigned int index, const nkMemory::StringView &label, const nkMemory::StringView &extension)
 
void setFollowSelfDir (bool value)
 
bool getFollowSelfDir () const
 
void setCurrentDir (const nkMemory::StringView &path)
 
nkMemory::StringView getCurrentDir () const
 
virtual nkMemory::String openDialog (bool forSave)=0
 
virtual void exportIntrospection (nkExport::Node *rootNode) override
 
virtual void importClassFromTree (nkExport::Node *rootNode) override
 
- Public Member Functions inherited from nkWinUi::Component
 Component (MainSystem *parentSystem)
 
virtual ~Component ()
 
LayoutgetLayout () const
 
ThemegetTheme () const
 
FontgetFont () const
 
nkMaths::Point getPositionInParent () const
 
nkMaths::Point getPositionInScreen () const
 
int getWidth () const
 
int getHeight () const
 
nkMaths::Rectangle getAreaInParent () const
 
nkMaths::Rectangle getAreaInScreen () const
 
virtual nkMaths::Point getBorderExtents () const
 
virtual float getBorderExtent (BORDER_KIND border) const
 
virtual int getLayoutAllowedWidth () const
 
virtual int getLayoutAllowedHeight () const
 
virtual int getLayoutAllowedOffsetX () const
 
virtual int getLayoutAllowedOffsetY () const
 
bool isInitialized () const
 
ComponentgetParentComponent () const
 
COMPONENT_TYPE getComponentType () const
 
nkMemory::StringView getComponentName () const
 
bool getVisibility () const
 
virtual nkMemory::StringView getLabel () const
 
void * getData () const
 
bool isEnabled () const
 
bool isForegroundWindow () const
 
unsigned int getZDepth () const
 
bool getVisibleOnLoad () const
 
std::function< bool(Component *)> getCloseCallback () const
 
std::function< void(Component *, bool)> getVisibilityCallback () const
 
std::function< void(Component *, const ClickEventData &)> getClickCallback () const
 
std::function< void(Component *, const WheelEventData &)> getWheelCallback () const
 
std::function< void(Component *, const KeyEventData &)> getKeyCallback () const
 
virtual LayoutsetLayout (LAYOUT_TYPE layoutType)
 
virtual void setTheme (Theme *theme)
 
virtual void setFont (Font *font)
 
virtual void setPositionInParent (nkMaths::Point position)
 
virtual void setPositionInScreen (nkMaths::Point position)
 
virtual void setSize (int width, int height)
 
virtual void setWidth (int width)
 
virtual void setHeight (int height)
 
void setMinSize (unsigned int width, unsigned int height)
 
void setMaxSize (unsigned int width, unsigned int height)
 
void setRatio (float widthOverHeight)
 
virtual void setAreaInParent (const nkMaths::Rectangle &area)
 
virtual void setAreaInScreen (const nkMaths::Rectangle &area)
 
virtual void setParentComponent (Component *parent, bool makeItVisible=true)
 
virtual void setLabel (const nkMemory::StringView &label)
 
void setComponentName (const nkMemory::StringView &name)
 
virtual void setVisibility (bool value)
 
void setData (void *data)
 
void setEnabled (bool value)
 
void setVisibleOnLoad (bool value)
 
void setCloseCallback (std::function< bool(Component *caller)> callback)
 
void setVisibilityCallback (std::function< void(Component *caller, bool visibility)> callback)
 
void setClickCallback (std::function< void(Component *caller, const ClickEventData &eventData)> callback)
 
void setWheelCallback (std::function< void(Component *caller, const WheelEventData &eventData)> callback)
 
void setKeyCallback (std::function< void(Component *caller, const KeyEventData &eventData)> callback)
 
void addChild (Component *child, bool makeItVisible=true)
 
void removeChild (Component *child)
 
void removeChild (unsigned int index)
 
ComponentgetChild (unsigned int index)
 
unsigned int getChildIndex (Component *child)
 
void unloadWithChildren ()
 
void loadWithChildren ()
 
void updateZDepth ()
 
void bringToForeground ()
 
void focusWindow ()
 
nkMaths::Point getCoordRelativeFromAbsolute (const nkMaths::Point &absCoords)
 
nkMaths::Point getCoordAbsoluteFromRelative (const nkMaths::Point &relCoords)
 
virtual void load ()=0
 
virtual void unload ()=0
 
void reload ()
 
virtual void updateWindow ()
 
nkImages::Image paintToImage (bool withFrame=false)
 
void simulateEvent (const InputDescriptor &inputDescription)
 
void onSized ()
 
virtual void exportClassToTree (nkExport::Node *rootNode) override
 
- Public Member Functions inherited from nkExport::Exportable
 Exportable ()
 
virtual ~Exportable ()
 

Detailed Description

A graphical file explorer.

Constructor & Destructor Documentation

◆ FileExplorer()

nkWinUi::FileExplorer::FileExplorer ( MainSystem parentSystem)

Constructor.

Parameters
parentSystemThe parent system in which the component will live.
Remarks
See ComponentManager::createOrRetrieve().

◆ ~FileExplorer()

nkWinUi::FileExplorer::~FileExplorer ( )

Destructor.

Member Function Documentation

◆ addFilter()

void nkWinUi::FileExplorer::addFilter ( const nkMemory::StringView label,
const nkMemory::StringView extension 
)

Adds a filter to the exploring.

Parameters
labelThe label to designate the filter.
extensionThe extension the filter will filter.

◆ getFilter()

FileFilter& nkWinUi::FileExplorer::getFilter ( unsigned int  index)

Gets a set filter.

Parameters
indexThe index of the filter to retrieve.
Returns
The filter at given index, if available. If out of bounds, the last filter is returned.

◆ setFilter()

void nkWinUi::FileExplorer::setFilter ( unsigned int  index,
const nkMemory::StringView label,
const nkMemory::StringView extension 
)

Change the filter at given index.

Parameters
indexThe index of the filter to change.
labelThe label to set for the filter.
extensionThe extension to use for the filter.

◆ setFollowSelfDir()

void nkWinUi::FileExplorer::setFollowSelfDir ( bool  value)

Sets whether the explorer should keep track of its directory or not.

Parameters
valueIf the tracking should occur (true) or not (false).

◆ getFollowSelfDir()

bool nkWinUi::FileExplorer::getFollowSelfDir ( ) const
Returns
Whether this component tracks its active folder (true) or not (false).

◆ setCurrentDir()

void nkWinUi::FileExplorer::setCurrentDir ( const nkMemory::StringView path)

Sets the directory the explorer will start in.

Parameters
pathThe path the directory should use for its folder.

◆ getCurrentDir()

nkMemory::StringView nkWinUi::FileExplorer::getCurrentDir ( ) const
Returns
The current dir the explorer tracks.

◆ openDialog()

virtual nkMemory::String nkWinUi::FileExplorer::openDialog ( bool  forSave)
pure virtual

Opens the explorer dialog for file searching.

Parameters
forSaveWhether this dialog will be used to save a new file (true) or not (false).
Returns
The absolute path the user selected using the dialog.

◆ exportIntrospection()

virtual void nkWinUi::FileExplorer::exportIntrospection ( nkExport::Node rootNode)
overridevirtual

◆ importClassFromTree()

virtual void nkWinUi::FileExplorer::importClassFromTree ( nkExport::Node rootNode)
overridevirtual

The documentation for this class was generated from the following file: